home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
XmQTcontainerItem.z
/
XmQTcontainerItem
Wrap
Text File
|
1998-10-30
|
17KB
|
265 lines
XXXXmmmmQQQQTTTTccccoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmQQQQTTTTccccoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm((((3333XXXX))))
NNNNAAAAMMMMEEEE
_X_m_Q_T_c_o_n_t_a_i_n_e_r_I_t_e_m - A widget holding this trait can serve as
a child of a widget holding the XmQTcontainer trait
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/ContItemT.h>
typedef struct {
Mask valueMask;
unsigned char view_type;
unsigned char visual_emphasis;
Dimension icon_width;
Cardinal detail_count;
} XmContainerItemDataRec, *XmContainerItemData;
typedef struct {
int version;
XmContainerItemSetValuesProc setValues;
XmContainerItemGetValuesProc getValues;
} XmContainerItemTraitRec, *XmContainerItemTrait;
vvvvooooiiiidddd ((((****XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmmSSSSeeeettttVVVVaaaalllluuuueeeessssPPPPrrrroooocccc))))(
WWWWiiiiddddggggeeeetttt,
XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmmDDDDaaaattttaaaa,
vvvvooooiiiidddd ((((****XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmmGGGGeeeettttVVVVaaaalllluuuueeeessssPPPPrrrroooocccc))))(
WWWWiiiiddddggggeeeetttt,
XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmmDDDDaaaattttaaaa);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
A widget holding the _X_m_Q_T_c_o_n_t_a_i_n_e_r_I_t_e_m trait can serve as a
child to a widget holding the _X_m_Q_T_c_o_n_t_a_i_n_e_r trait.
XXXXmmmmIIIIccccoooonnnnGGGGaaaaddddggggeeeetttt is the only standard Motif class holding the
_X_m_Q_T_c_o_n_t_a_i_n_e_r_I_t_e_m trait. XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr is the only standard
Motif widget that examines its children for this trait.
TTTThhhheeee sssseeeettttVVVVaaaalllluuuueeeessss TTTTrrrraaaaiiiitttt MMMMeeeetttthhhhoooodddd
vvvvooooiiiidddd sssseeeettttVVVVaaaalllluuuueeeessss(
WWWWiiiiddddggggeeeetttt ccccoooonnnnttttaaaaiiiinnnneeeerrrrCCCChhhhiiiillllddddWWWWiiiiddddggggeeeetttt,
XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmmDDDDaaaattttaaaa ccccoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmmDDDDaaaattttaaaa);
A container widget (such as XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr) calls the sssseeeettttVVVVaaaalllluuuueeeessss
trait method of its _c_o_n_t_a_i_n_e_r_C_h_i_l_d_W_i_d_g_e_tin order to set
certain visual properties.
_c_o_n_t_a_i_n_e_r_C_h_i_l_d_W_i_d_g_e_t
Specifies the container child widget that is
holding this trait.
_c_o_n_t_a_i_n_e_r_I_t_e_m_D_a_t_a
Page 1 (printed 10/24/98)
XXXXmmmmQQQQTTTTccccoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmQQQQTTTTccccoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm((((3333XXXX))))
Specifies an XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmmDDDDaaaattttaaaa structure. This
structure holds five fields, but only the first
three fields are meaningful to the sssseeeettttVVVVaaaalllluuuueeeessss trait
method. Following is a description of those three
fields:
_v_a_l_u_e_M_a_s_k Specifies a bit mask. Each bit in the
bit mask symbolizes a visual property
affected by the sssseeeettttVVVVaaaalllluuuueeeessss trait method.
If a particular bit is set to 1,
sssseeeettttVVVVaaaalllluuuueeeessss modifies the associated visual
property. If this same bit holds a 0,
sssseeeettttVVVVaaaalllluuuueeeessss does not modify the associated
visual property. To help you set bits,
the CCCCoooonnnnttttIIIItttteeeemmmmTTTT....hhhh header file provides
three relevant constants.
CCCCoooonnnnttttIIIItttteeeemmmmVVVViiiieeeewwwwTTTTyyyyppppeeee
Sets the _v_i_e_w__t_y_p_e visual
property bit to 1.
CCCCoooonnnnttttIIIItttteeeemmmmVVVViiiissssuuuuaaaallllEEEEmmmmpppphhhhaaaassssiiiissss
Sets the sssseeeettttVVVVaaaalllluuuueeeessss visual
property bit to 1.
CCCCoooonnnnttttIIIItttteeeemmmmAAAAllllllllVVVVaaaalllliiiidddd
Sets both visual property bits
to 1.
_v_i_e_w__t_y_p_e Specifies the view type of _w_i_d_g_e_t. For
example, when XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr calls
sssseeeettttVVVVaaaalllluuuueeeessss, it passes a _v_i_e_w__t_y_p_e value
of either XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN or XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN.
(See the XXXXmmmmIIIIccccoooonnnnGGGGaaaaddddggggeeeetttt(3) reference page
for a description of XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN and
XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN.)
_v_i_s_u_a_l__e_m_p_h_a_s_i_s
Specifies the visual emphasis of _w_i_d_g_e_t.
For example, when XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr calls
sssseeeettttVVVVaaaalllluuuueeeessss, it passes a _v_i_s_u_a_l_E_m_p_h_a_s_i_s
value of either XXXXmmmmSSSSEEEELLLLEEEECCCCTTTTEEEEDDDD or
XXXXmmmmNNNNOOOOTTTT____SSSSEEEELLLLEEEECCCCTTTTEEEEDDDD. See the XXXXmmmmIIIIccccoooonnnnGGGGaaaaddddggggeeeetttt(3)
reference page for a description of
XXXXmmmmSSSSEEEELLLLEEEECCCCTTTTEEEEDDDD and XXXXmmmmNNNNOOOOTTTT____SSSSEEEELLLLEEEECCCCTTTTEEEEDDDD.
TTTThhhheeee ggggeeeettttVVVVaaaalllluuuueeeessss TTTTrrrraaaaiiiitttt MMMMeeeetttthhhhoooodddd
vvvvooooiiiidddd ggggeeeettttVVVVaaaalllluuuueeeessss(
WWWWiiiiddddggggeeeetttt ccccoooonnnnttttaaaaiiiinnnneeeerrrrCCCChhhhiiiillllddddWWWWiiiiddddggggeeeetttt,
XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmmDDDDaaaattttaaaa ccccoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmmDDDDaaaattttaaaa);
A container widget calls the ggggeeeettttVVVVaaaalllluuuueeeessss trait method of its
Page 2 (printed 10/24/98)
XXXXmmmmQQQQTTTTccccoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmQQQQTTTTccccoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm((((3333XXXX))))
_c_o_n_t_a_i_n_e_r_C_h_i_l_d_W_i_d_g_e_t to determine what visual properties the
_c_o_n_t_a_i_n_e_r_C_h_i_l_d_W_i_d_g_e_t provides.
_c_o_n_t_a_i_n_e_r_C_h_i_l_d_W_i_d_g_e_t
Specifies the child widget that is holding this
trait.
_c_o_n_t_a_i_n_e_r_I_t_e_m_D_a_t_a
Specifies an XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmmDDDDaaaattttaaaa structure. This
structure holds the following five fields:
_v_a_l_u_e_M_a_s_k Specifies a bit mask. Each bit in the
bit mask symbolizes a visual property
returned by the ggggeeeettttVVVVaaaalllluuuueeeessss trait method.
If the caller sets a particular bit to
1, ggggeeeettttVVVVaaaalllluuuueeeessss returns meaningful
information about the associated visual
property. However, if the caller places
a 0 in this same bit, then ggggeeeettttVVVVaaaalllluuuueeeessss
does not return meaningful information
about the associated visual property. In
short, the _v_a_l_u_e_M_a_s_k lets the caller
specify the visual properties that it is
interested in. To help you set bits,
the CCCCoooonnnnttttIIIItttteeeemmmmTTTT....hhhh header file provides the
following five constants:
CCCCoooonnnnttttIIIItttteeeemmmmVVVViiiieeeewwwwTTTTyyyyppppeeee
Sets the _v_i_e_w__t_y_p_e visual
property bit to 1.
CCCCoooonnnnttttIIIItttteeeemmmmVVVViiiissssuuuuaaaallllEEEEmmmmpppphhhhaaaassssiiiissss
Sets the _v_i_s_u_a_l__e_m_p_h_a_s_i_s
visual property bit to 1.
CCCCoooonnnnttttIIIItttteeeemmmmIIIIccccoooonnnnWWWWiiiiddddtttthhhh
Sets the iiiiccccoooonnnn____wwwwiiiiddddtttthhhh visual
property bit to 1.
CCCCoooonnnnttttIIIItttteeeemmmmDDDDeeeettttaaaaiiiillllCCCCoooouuuunnnntttt
Sets the _d_e_t_a_i_l__c_o_u_n_t visual
property bit to 1.
CCCCoooonnnnttttIIIItttteeeemmmmAAAAllllllllVVVVaaaalllliiiidddd
Sets all four visual property
bits to 1.
_v_i_e_w__t_y_p_e Returns the view type of
_c_h_i_l_d_C_o_n_t_a_i_n_e_r_W_i_d_g_e_t. If XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr is
managing _c_o_n_t_a_i_n_e_r_C_h_i_l_d_W_i_d_g_e_t,
XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr expects that the returned
value will be either XXXXmmmmLLLLAAAARRRRGGGGEEEE____IIIICCCCOOOONNNN or
Page 3 (printed 10/24/98)
XXXXmmmmQQQQTTTTccccoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmQQQQTTTTccccoooonnnnttttaaaaiiiinnnneeeerrrrIIIItttteeeemmmm((((3333XXXX))))
XXXXmmmmSSSSMMMMAAAALLLLLLLL____IIIICCCCOOOONNNN. See the XXXXmmmmIIIIccccoooonnnnGGGGaaaaddddggggeeeetttt(3)
reference page for a description of
these two values.
_v_i_s_u_a_l__e_m_p_h_a_s_i_s
Returns the visual emphasis of
_c_h_i_l_d_C_o_n_t_a_i_n_e_r_W_i_d_g_e_t. If XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr is
managing _w_i_d_g_e_t, XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr expects
that the returned value will be either
XXXXmmmmSSSSEEEELLLLEEEECCCCTTTTEEEEDDDD or XXXXmmmmNNNNOOOOTTTT____SSSSEEEELLLLEEEECCCCTTTTEEEEDDDD. (See the
XXXXmmmmIIIIccccoooonnnnGGGGaaaaddddggggeeeetttt(3) reference page for a
description of these two values.)
_i_c_o_n__w_i_d_t_h
Returns the width of the icon. (This
width will not include the width of any
associated detail strings.)
_d_e_t_a_i_l__c_o_u_n_t
Returns the number of details strings in
this container child.
RRRREEEELLLLAAAATTTTEEEEDDDD
EEEExxxxmmmmGGGGrrrriiiidddd(3), XXXXmmmmCCCCoooonnnnttttaaaaiiiinnnneeeerrrr(3), XXXXmmmmIIIIccccoooonnnnGGGGaaaaddddggggeeeetttt(3), and
XXXXmmmmQQQQTTTTccccoooonnnnttttaaaaiiiinnnneeeerrrr(3).
Page 4 (printed 10/24/98)